home *** CD-ROM | disk | FTP | other *** search
- PIN entry for Debian
- --------------------
-
- This package and its sibling packages are intended to be used as a
- pass-phrase entry dialog for the program gpg-agent (Debian package
- gnupg-agent). To configure gpg-agent to use one of the provided
- pinentry programs, put something like this into your
- ~/.gnupg/gpg-agent.conf:
-
- pinentry-program /usr/bin/pinentry-qt4
-
- You have the following pinentry variants to choose from:
-
- /usr/bin/pinentry
- Generic name that points, via the Debian alternatives system, to
- the "best" installed PIN entry program. gpg-agent uses this by
- default.
-
- /usr/bin/pinentry-x11
- Generic name that points, via the Debian alternatives system, to
- the "best" installed PIN entry program with X11 support (that is,
- the GTK+, GTK+ 2, Qt, or Qt 4 flavor).
-
- /usr/bin/pinentry-curses
- Text-mode PIN entry program that uses the curses tool kit (package
- pinentry-curses).
-
- /usr/bin/pinentry-gtk
- Graphical PIN entry program that uses the GTK+ tool kit version 1
- (package pinentry-gtk).
-
- /usr/bin/pinentry-gtk-2
- Graphical PIN entry program that uses the GTK+ tool kit version 2
- (package pinentry-gtk2).
-
- /usr/bin/pinentry-qt
- Graphical PIN entry program that uses the Qt 3 tool kit (package
- pinentry-qt).
-
- /usr/bin/pinentry-qt4
- Graphical PIN entry program that uses the Qt 4 tool kit (package
- pinentry-qt4).
-
- The programs pinentry-gtk, pinentry-gtk-2, and pinentry-qt* automatically
- fall back to the curses interface if no X Window System is available.
- So for example, if you frequently switch between text mode and KDE, and
- you want to use both Mutt and KMail with GnuPG pass-phrase agent support,
- then configuring /usr/bin/pinentry-qt would work. (In this case,
- leaving it at /usr/bin/pinentry would also work, since pinentry-qt is
- the preferred alternative overall, but if you prefer to use, say,
- pinentry-gtk, then you need to set it up explicitly (or manually alter
- the alternatives system; the possibilities abound).)
-
- pinentry-qt4 is intended for users of KDE 4, whereas pinentry-qt uses
- Qt 3, which is more suitable for users of KDE 3. pinentry-qt4 is not
- maintained by the upstream authors of the other pinentry packages (yet),
- but by the KDE team (for the time being).
-
- Note that for the complete system to work, you also need to configure
- GnuPG to use the gpg-agent to get the pass phrases, and you need to
- configure your e-mail client to use GnuPG. These issues are not
- covered here.
-
- -- Peter Eisentraut <petere@debian.org>, 2008-04-20
-